home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / qwksl103.zip / QWKSLICE.DOC < prev    next >
Text File  |  1994-05-24  |  5KB  |  105 lines

  1.                             QWKSLICE Version 1.03
  2.                           May be freely distributed
  3.  
  4.  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE
  5.  
  6.   There is no warranty of any kind, either express or implied, covering
  7.   this software or any associated materials.  This software and all
  8.   associated materials are provided as is, use them at your own risk.
  9.   The copyright holder is in no way responsible or liable for any losses or
  10.   damages of any kind that may result from the use of this software or any
  11.   associated materials, or from inability to use them.
  12.  
  13.  
  14.   All brand or product names mentioned in this documentation or any
  15.   associated files are trademarks or registered trademarks of their
  16.   respective owners.  All products mentioned are copyrighted by their
  17.   respective owners.
  18.  
  19.  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE  NOTICE
  20.  
  21.  
  22.  
  23.  
  24.    QWKSLICE is a packet slicer, occasionally you may run into a packet is
  25. a little too large for your mailer or possibly your mailer doesn't have
  26. enough free memory to load the packet into.  This is where QWKSLICE is a
  27. real life saver.  There has been numerous times where I have needed a little
  28. gem like this, especially when dealing with a QWK compatible door called
  29. MajorQWK for MajorBBS systems, it doesn't even slice packets at all, and very
  30. often systems using MajorBBS have large amounts of incoming mail.
  31.  
  32.    QWKSLICE is automatic as far as the slicer goes.  There is a few
  33. modifications that will need to be made to the batch files included.
  34. QWKSLICE is started by executing SLICE.BAT.  SLICE.BAT has two variables
  35. defined at the beginning of the batch file.
  36.  
  37. @ECHO OFF
  38. SET WORK=$$WORK$$.$$$            <- These are the variables I am
  39. SET INBOUND=C:\OLX            <- talking about.
  40. IF (%1) == () GOTO ERROR
  41.  
  42. You don't need to worry about the WORK variable, but you must put a directory
  43. name (no backslash following the directory) in the INBOUND variable.  This
  44. is already set to C:\OLX, but there is dozens of different offline mail
  45. readers.  The directory name you are going to put there will be the INBOUND
  46. directory name for your QWK compatible offline mail reader.  Since QWKSLICE
  47. doesn't have any fancy detection routines to determine the compression used
  48. you must either manually unpack and modify SLICE.BAT or know the compression
  49. program that is used before using SLICE.BAT, most use PKZIP, let's hope you
  50. do too.
  51.  
  52.    QWKSLICE will call a batch file named REPACK.BAT, two parameters are passed
  53. to REPACK.BAT, %1 will be the BBSID (obtained from CONTROL.DAT), and %2 will
  54. be the packet number.  REPACK.BAT will use PKZIP and the INBOUND variable to
  55. recompress the data file (plus CONTROL.DAT and DOOR.ID, no *.NDX files are
  56. reproduced with QWKSLICE -- most offline readers do not need them) in your
  57. INBOUND directory (which is defined in SLICE.BAT).
  58.  
  59.    QWKSLICE has a third batch file included, this one is called OLR.BAT and
  60. is only known to work with OLX and possibly SLMR offline mail readers.  It
  61. will use STRINGS.COM from PC Magazine to increment a variable and call the
  62. offline reader with the packet name on the command line, OLX would
  63. automatically decompress the packet without any problems.
  64.  
  65.    QWKSLICE will attempt to read a file called QWKSLICE.CFG, if it doesn't
  66. exist then QWKSLICE will assume certain defaults.  The following is a list
  67. of commands that will change these preset defaults, they must be entered
  68. on seperate lines in QWKSLICE.CFG and they must be terminated with a carriage
  69. return and line feed.
  70.  
  71. MAXMSGCONF=n
  72.    This will set the maximum messages per conference to n messages.  (default
  73.    is 500).
  74.  
  75. MAXMSGPACKET=n
  76.    This will set the maximum messages per packet to n messages.  (default is
  77.    2000).
  78.  
  79. MAXPKTSIZE=n
  80.    This will set the maximum size of the MESSAGES.DAT data file to n bytes.
  81.    (default is 262144 or 256K).
  82.  
  83.    There is a sample configuration file included, it is set to the defaults
  84. which is perfect for me.  When QWKSLICE encounters any one of these limits it
  85. will increment the packet number and start creating another packet, none of
  86. these values can be turned off.
  87.  
  88.  
  89.    QWKSLICE supports a maximum of 10,000 conferences numbered from 0 to
  90. 9,999.  If your packet exceeds this amount it may cause your system to lock
  91. up, there wasn't any safety feature for this implemented.  (I have never seen
  92. a board with even 1,000 conferences).
  93.  
  94.  
  95. NET-STATUS BLOCK
  96.    QWKSLICE will ignore NSBs, if the Message Active field is not equal to 0xE1
  97. or 0xE2 then it will assume it is a NSB and terminate all processing.
  98. QWKSLICE will NOT add the NSB to the new packets.
  99.  
  100.  
  101. I may be contacted in the following ways:
  102.  
  103.   Fidonet: Chad Wagner@1:369/120
  104.  Internet: cmwagner@gate.net
  105.